home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 July / EnigmA AMIGA RUN 29 (1998)(G.R. Edizioni)(IT)[!][issue 1998-07 & 08].iso / recent / crunch.lha / crunchdir / crunchdir_D.txt < prev    next >
Text File  |  1998-06-15  |  9KB  |  219 lines
  1.  
  2.                           CrunchDir v1.26 (05.04.98)
  3.                          ----------------------------
  4.  
  5.                                    Anleitung
  6.                                   -----------
  7.  
  8.   ===========================================================================
  9.   0.    Inhalt
  10.   ---------------------------------------------------------------------------
  11.  
  12.         1. Vorwort
  13.         2. Was macht CrunchDir
  14.         3. Systemanforderungen
  15.         4. Installation
  16.         5. Parameter
  17.         6. Autor
  18.         7. Danksagungen
  19.  
  20.   ===========================================================================
  21.   1.    Vorwort
  22.   ---------------------------------------------------------------------------
  23.  
  24.   Dieses  Programm  und  alle im Paket befindlichen Dateien sind © 1997/98 by
  25.   Thomas Knuppe.  Sie dürfen frei kopiert  werden solange das Archiv und alle
  26.   in ihm enthaltenen Dateien unverändert bleiben.
  27.  
  28.   Ich,  der   Autor  dieses  Programmpakets,  übernehme   keine  Haftung  für
  29.   irgendwelche   Schäden,  die   während  oder  nach   der  Benutzung  dieses
  30.   Programms entstehen.
  31.  
  32.   Das  Programm  wurde  mit  Amiga_E  auf  einem  Amiga  4000/030  mit  OS3.1
  33.   geschrieben und ausgiebig auf einem A4000 und A3000T getestet.
  34.  
  35.   Sollte es dennoch fehlerhaft arbeiten bitte ich, mich zu benachrichtigen.
  36.  
  37.  
  38.   ===========================================================================
  39.   2.    Was macht CrunchDir
  40.   ---------------------------------------------------------------------------
  41.  
  42.   Ich  habe  CrunchDir  geschrieben,  da  es meinem BBS-Programm (AMMS) nicht
  43.   möglich  ist  Binärbrettinhalte   nach  Menge  oder  Haltezeit  (sprich  in
  44.   irgendeiner Form dynamisch) zu verwalten.
  45.  
  46.   Crunchdir scannt rekursiv ein übergebenes  Verzeichnis nach Dateien die ein
  47.   bestimmtes   Alter   überschreiten.   Diese  Dateien   werden  dann  sofort
  48.   gelöscht.
  49.  
  50.  
  51.   ===========================================================================
  52.   3.    Systemanforderungen
  53.   ---------------------------------------------------------------------------
  54.  
  55.   Das  Programm  benötigt lediglich  einen Amiga mit OS2.04 (oder besser) und
  56.   mindestens eine 68000 CPU.
  57.  
  58.   CrunchDir  läuft  auf  2  Mailboxsystemen  in  täglichem   Einsatz  absolut
  59.   problemlos.
  60.  
  61.  
  62.   ===========================================================================
  63.   4.    Installation
  64.   ---------------------------------------------------------------------------
  65.  
  66.   Die  Installation ist denkbar einfach:  Das Programm  'CrunchDir' in das C: 
  67.   Verzeichnis  kopieren.   Puuh  - und jetzt die Schweissperlen von der Stirn
  68.   wischen :-)
  69.  
  70.  
  71.   ===========================================================================
  72.   5.    Parameter
  73.   ---------------------------------------------------------------------------
  74.  
  75.   Dem  Programm  können/müssen  folgende  Argumente  übergeben werden  um die
  76.   Arbeitsweise zu beeinflussen :
  77.  
  78.   Template    :   DIR/A,PATTERN,DAYS=D/K/N,LOGFILE=LOG/K,NOTIME/S,ADDLOG/S:
  79.  
  80.   DIR/A       :   Das  zu durchsuchende Verzeichnis.  Das Programm geht dabei
  81.                   rekursiv jedes Unterverzeichnis durch.
  82.  
  83.                   Dieses   Argument   _MUSS_   angegeben  werden.   Wird  ein
  84.                   Leerstring  übergeben,  scannt das Programm  automatisch im
  85.                   aktuellen Pfad!
  86.  
  87.   PATTERN     :   AmigaDOS-Pattern   um   die   zu   beeinflussenden  Dateien
  88.                   auszuwählen.  Z.B.  würde (b#?)  nur alle  Dateien scannen,
  89.                   die  mit  einem 'b' anfangen.  ACHTUNG:  Dieser Pattern ist
  90.                   Case-Sensitiv,   d.h.    es   wird   zwischen   Groß-   und
  91.                   Kleinschreibung unterschieden !!
  92.  
  93.                   Wird  dieses Argument  weggelassen, geht das Programm davon
  94.                   aus,  dass  jede   Datei  gescannt  werden  soll   (was dem
  95.                   Pattern "(#?)" gleichkommen würde).
  96.  
  97.                   Wie  vom  AmigaDOS  gewohnt,  sind  auch negierte  Patterns
  98.                   möglich (z.B.: ~(#?.txt) ).
  99.  
  100.   DAYS=D      :   Mit  diesem  Argument übergibt  man dem Programm die Anzahl
  101.                   der Tage, die vom aktuellen  Datum abgezogen  werden sollen
  102.                   um das Mindestalter der zu löschenden Files festzulegen.
  103.  
  104.                   Das klingt komplizierter als es ist. Beispiel:
  105.  
  106.                   Es  sollen nur  Dateien gelöscht  werden die älter sind als
  107.                   20 Tage :  D=20
  108.  
  109.                   Dieses  Argumment ist ein sogenanntes KEYWORD.  Es muss bei
  110.                   der Angabe mit übergeben werden.  Beispiele wären:
  111.  
  112.                   DAYS=10 , D 5 , D=70
  113.  
  114.                   Wird  dieses   Argument nicht übergeben oder  überschreitet
  115.                   die  Tagesangabe  das  aktuelle Datum, benutzt das Programm
  116.                   die Standardeinstellung von 30 Tagen.
  117.  
  118.   LOGFILE=LOG :   Durch  Angabe dieses Schlüsselwortes  und eines Dateinamens
  119.                   wird   ein   Logfile   unter   dem  angegebenen  Dateinamen
  120.                   generiert.
  121.  
  122.                   Beispiel:  LOG="RAM:CD-LOG.TXT"
  123.  
  124.                   Während  des  benutzens von CrunchDir wird  zusätzlich eine
  125.                   temporäre  Datei  "CD-LOG.TMP"  im logischen Verzeichnis T:
  126.                   angelegt.   Diese  Datei  wird  beim  Beenden von CrunchDir
  127.                   automatisch entfernt
  128.  
  129.                   Das  Logfile  erhält  zusätzlich  einen Dateikommentar, der
  130.                   Aufschluss  darüber gibt  wieviele Dateien  gelöscht wurden
  131.                   und ob Fehler aufgetreten sind.
  132.  
  133.   NOTIME/S    :   Damit  kann  die  Uhrzeit  (die  einer  Datei  und  die des
  134.                   aktuellen  Datums)  ignoriert  werden.   Dadurch werden nur
  135.                   Dateien gelöscht, die tatsächlich x Tage alt sind.
  136.  
  137.   ADDLOG/S    :   Durch diesen Schalter kann ein neu erzeugtes Logfile (siehe
  138.                   Parameter  "LOGFILE") an ein  bestehendes angehängt werden.
  139.                   Die   einzelnen   Einträge   werden   räumlich  voneinander
  140.                   getrennt und mit eigenem Header versehen.
  141.  
  142.                   Der  Filekommentar  (siehe Parameter "LOGFILE") enthält bei
  143.                   diesem  Parameter nur Informationen über den letzten Aufruf
  144.                   von CrunchDir !
  145.  
  146.  
  147.   Beispiel für einen Aufruf des Programms:
  148.  
  149.   Crunchdir Files:Stuff ~(BOARDINFO#?) D=2 LOGFILE T:Crunchdir.log
  150.  
  151.   Dieser   Aufruf   würde  alle   Files  im  Verzeichnis  "Files:Stuff"  (und
  152.   darunterliegenden  Verzeichnissen) ,  die älter als  2 Tage  sind, löschen.
  153.   Davon  ausgeschlossen  werden  Dateien,  die  mit "BOARDINFO" anfangen oder
  154.   genauso   heissen.    Zusätzlich   wird   ein   Logfile  unter   dem  Namen
  155.   "Crunchdir.log" im logischen Verzeichnis T:  erzeugt.
  156.  
  157.   Die  Uhrzeit  der  zu  löschenden  Datei(en)  und die des  aktuellen Datums
  158.   werden  zur  Zeitberechnung  benutzt.   Die  Uhrzeit  kann mit dem Schalter
  159.   NOTIME/S (siehe oben) ignoriert werden.
  160.  
  161.  
  162.   ACHTUNG !!    Das Programm löscht nur  Dateien die ohne  weiteres Zutun
  163.                 gelöscht werden  können.  D.h. die  Protection-Bits einer
  164.                 Datei bleiben unverändert.  Wenn eine Datei also z.B. vor
  165.                 löschen  geschützt  ist, wird  sie  einfach  ausgelassen.
  166.                 Eine Fehlerausgabe findet nur statt,  wenn zusätzlich ein
  167.                 Logfile generiert wird !
  168.  
  169.  
  170.   ===========================================================================
  171.   6.    Autor
  172.   ---------------------------------------------------------------------------
  173.  
  174.   Dieses wunderbare Programm hat geschrieben :
  175.  
  176.   Thomas 'Shadow' Knuppe aus Berlin, Deutschland
  177.  
  178.   Ich bin unter folgenden Adressen erreichbar :
  179.  
  180.   E-Mail        :       EsHaDe@gmx.de
  181.  
  182.   Home          :       http://home.pages.de/~shd
  183.  
  184.   IRC           :       'sHD' oder 'EsHaDe' on IRCNet
  185.  
  186.   FAX           :       +49 (0)30 667 09 543
  187.  
  188.   BBS           :       Outside world - +49 (0)30 667 09 150    X.75
  189.                                                   667 09 151    v34+
  190.                                                   667 09 543    v32b/ZyX +FAX
  191.                         [AMMS 3]                  667 09 544    v32b
  192.  
  193.  
  194.   ===========================================================================
  195.   7.    Danksagungen
  196.   ---------------------------------------------------------------------------
  197.  
  198.   Mein Dank geht an folgende Personen:
  199.  
  200.   Till 'MacGyver' Klöpping        -     Ohne  Deine  Routinen  wäre ich  wohl
  201.                                         nicht so schnell dahintergestiegen :)
  202.  
  203.   Ronny 'Cannon' Schulz [IDP!]    -     Der wahrscheinlich  die bisher besten
  204.                                         Tools  für AMMS  geschrieben  hat und
  205.                                         hoffentlich weiterhin schreiben wird.
  206.  
  207.   Roman 'Galax-e' Harneit         -     Für alles was wir  bisher 'gemeinsam'
  208.                                         durchgestanden haben =)  1997 rules !
  209.  
  210.   Rolf 'Digi-Bit' Müller          -     Für die Verbesserungsvorschläge ...
  211.  
  212.   Enya                            -     Für  die  entspannende   Musik  beim
  213.                                         Proggen =)
  214.  
  215.   Wouter van Oortmerssen          -     Für die genialste Programmiersprache
  216.                                         überhaupt :) (Amiga_E)
  217.  
  218. ------------------------------------------------------------------------------
  219.